Instruction on how to use the data and code associated with the manuscript entitled:

"Quantifying Women’s Marginalisation in Ibero-American Film Culture During the First Half of the Twentieth Century: A Network-Science Proposal"

authored by A. Clariana-Rodagut and A. Cardillo


@@@@@@@@@@@@@@@@@@@@@@@@
@
@  ARCHIVE'S STRUCTURE
@
@@@@@@@@@@@@@@@@@@@@@@@@


The data and code are located in two separate directories named:

data/
code/

A third directory named "results" is needed in order to generate the output (figures and results).


@@@@@@@@@@@@@@@@@@@@@@@@
@
@        DATA
@
@@@@@@@@@@@@@@@@@@@@@@@@


The data are stored in JSON files. There are five networks, each corresponding to a distinct type of interaction. For each network, there are two JSON files:

XXXX-graph_nodes.json
XXXX-graph_edges.json

Where XXXX can be one of the following:

cb   --> Collective Bodies
cor  --> Correspondence 
ev   --> Events
pub  --> Publication
rel  --> Relationships

The files whose names end with "_nodes" store the information concerning the nodes of network, whereas the files whose names end with "_edges" store the information on the connections (i.e., edges) between nodes. Each JSON file contain several elements like:

## FILE OF THE NODES ##


"AAAAA": {
	"name": "BBBBB" ,
	"gender": "CCCCC"
},

Where:

AAAAA --> Unique numerical ID assigned to each person.
BBBBB --> The name of the person stored as SURNAME(s), NAME(s).
CCCCC --> The gender of the person (possible values: "male", "female", and "unknown").


## FILE OF THE EDGES ##

"AAAAA": [
    BBBBB,
    CCCCC,
    {
        "weight": DDDDD,
        "etype": "EEEEE"
    }
],

Where:

AAAAA --> Unique numerical ID assigned to the edge.
BBBBB --> ID of the node (person).
CCCCC --> ID of the node (person).
DDDDD --> Weight of the edge (integer number).
EEEEE --> Edge type (possible values: "coll_body", "correspondence", "event", "publication", and "relationship").



@@@@@@@@@@@@@@@@@@@@@@@@
@
@        CODE
@
@@@@@@@@@@@@@@@@@@@@@@@@


The code to analyze the networks and generate the paper's figures is organized into three Jupyter notebook files contained inside the "code" directory. The files are:

analysis-of-multiplex_network.ipynb
analysis-of-networks.ipynb
graphics.ipynb 

Each file does the following:


analysis-of-networks.ipynb : This notebook contains the Python code to analyze the network obtained by merging together all the layer networks.

analysis-of-multiplex_network.ipynb: This notebook contains the Python code to analyze the network as a multiplex (i.e., a network with multiple layers).

graphics.ipynb : This notebook contains the Python code to generate the figures displayed in the manuscript. This notebook requires the execution of the other two which generate the necessary data files.


Copyleft 2024, Alessio Cardillo

 end of readme #
